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<DOCUI^ENTATION>TVEDIT. MANUAL 

HINT: The folloaing conisands allow you to read this manual using 

TV-Edit ("$" stands for typing the 'ESC or 'ALT MODE' before 
typing the command character(s)): 

SW to read the next uindou^ 

$-U to read the previous windotiv 

$10G to go to page 10, and 

SSF to finish (notice/ TWO ESCs and an F). 
fo suppress printing, type {CfiLt)-0 (useful on slou terninais). 
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0. BACKGftOOND 



TV-Edit Is a page-oriented text editor. It was originally writ- 
ten for the IMSSS/Stanford AX Project PDP-1 coaputer and Philco dis- 
plays by Brian Tolliver in 1965(?). Four of its "descendants", all 
written for the PDP-10, are currently in use at Stanford: two at the 
AI Project use the DATA-DISC display systea? one at li^SSS (by John 
Prebus, since 1970) uses the IMLAC PDS-1 display conputer; and the 
present one at IMSSS and SUMEX (by Pentti Kanerva, since 1972) with 
versions for TEC Series 400 and DATAHEDIA Elite 2500 displays, 

TV-Edit provides a window into a user's text file, with a sec- 
tion of the file (23 lines on TECs and DATAHEDIfis) displayed at once. 
Coajmands exist for moving this windoy to oifferent parts of the file 
and for altering text in the current window. When an editor coniBiand 
is typed, the aindou is iiBroediately updated to show the effect of the 
command on the text. 

iiihile editing, the user need not to concern himself with writ- 
ing the current window, or some internal text buffer, back on the 
physical records of the file. These manipulations are done auto- 
matically by the editor program. 'Finish* is the only coacmand where 
physical tile updating is explicitly specified by the user. 

Particular attention has been given to the amount of typing ne- 
cessary to perforin an editing function. Many coafflands require the 
typing of just one character. Frequently used sequences of commands 
and/or text can be defined as strings (macros), and reproduced by typ- 
ing only the string call character. 

As a rule, commands are entered "in the dark", i.e., the command 
characters themselves are not displayed as they are typed in. How- 
ever, once a command is completely entered, its effect on the file Is 
immediately visible. This instant feedback is Invaluable in learning 
to use the editor and in assuring the user that the right things are 
happening to his file. 



TV-Edit Documentation 



The present manual, <DOClJMENTATION>TVEDIT. MANUAL 
describes how to use TEC/DATAMEDIA TV-Edit. Chapters 1-3 give the 
basics of TV-editing, Chapter 4 deals with the more advanced features 
of the editor. 

Recent changes are reported in TV Sews or Updates, available 
through option "*" of the editor, or in <DOCOI'E6iTAT10N>TVEDIT. UPDATE 
Ho Implementation manual for the editor exists. 

*L 
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Assumptions of This Manual 



Basic knowledge of how to use the tiaiesharlng systero is assumed. 
At the least you must know how to log in and have a general idea of 
what a file is. In addition/ we assume that you want to do one of 
the following using the editor: (a) create a new file and write a 
feu lines of text in it; (b) modify an old file (correct a mispeling^ 
for instance); or (c) read an old fiie (the TV-Edit news file, for 
instance). 
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1. STARTING AND FINISHING 



Starting 

To use the editor, you wust log in on a TEC or DATAHEDIA terminal 
and call tor the editor prograro. Calling and starting the editor is 
explained below by means of an example. Me assume that you want to 
create a ne« file, give it the nane "FILEl", and start writing in it. 
In the example computer dialog is indented, 'CR' stands for the (Car- 
riage) Return key, 'ESC for the Escape key (labeled "ALT MODE" or 
"ENTER" on some keyboards), and your replies are indicated by an un- 
derline. To start, type 

"C 

gTVEDIT 'CR' 

i.e., you should type the word "TVEDIT" and then the RETURli key. 

T V - E D I T 
( ? for help, *• to start over) 
(File name, *, or :) FILEl 'CR' CNew Filel 'CR' 



You can enter the file name using the TENEX file name recogni- 
tion feature. The file must be a disk file. New files are created 
in the connected directory only. 

The second 'CR' confirms the file nane, but It also lets you re- 
view the standard options. For a fast start with standard options, 
confirm with an 'ESC instead. 

In place of the file name, you can type '•*" to read the latest 
News, ":" to read this wanual, or "?" to get a help message. 

When the editor Is restarted and a file nawe appears, followed 
by two slashes, as in 

(File name, *, or :) FILEl.;!//, 

you can either accept the file by typing 'CR' or 'ESC, or reject it 
by typing the naae of another file. 

PLACE LIST. The program asks for a list of places to edit: 
(Page. Line) 1// 'CR' 
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Typing 'CR' means that you accept the list that appears to the left 
of the double slash "//". The editor program will take you to the 
first place in the listy and while editing^ you can progress through 
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the list by using the "§" coBBiand. The place list has no significance 
when creating a new tile. 

A place is specified by a page number/ or hy a page number/ dot/ 
line number- Use spaces or commas between places in the list/ 'CR' 
or 'ESC* to terisinate the list. Example: 

(Page. Line) 1// 3 7.11 22.45/10.10 'CR' 

.PL FILES. The place list can also be read from a file. For 
the file "FILEi" the name of the place list file must be "#FILE1.PL" 
and for "FILEl.A" it roust be "#FILE1-A.PL". Such files are created 
by the "{.PL)" option of the SEARCH program. See: 

<D0CUMENTAT1QN>SEARCH. MANUAL for a description of the SEARCH program). 
The editor reads the first page (up to first Fora Feed character)/ but 
not fflore than 1000 characters/ of the .PL file. To read the list from 
a file/ type "@" at the "(Page. Line)" request. 

Next co«es a request for editing mode; 

(Mode: L/ U/ or R) L// 'CR' 

On DATAMEDIAs the usual choice is L for writing and modifying text. 
The distinction between L and U is Important on uppercase-only 
terminals such as the TFC. Even though TEC displays everything in 
upper case/ the text in your file can be in either upper or lower case. 
Here you are asked to specify the case that you MOSTLY use in entering 
text in the file. The "L" of the example means that you plan to type 
mainly In lower case. On a TEC terminal/ occasional uppercase letters 
for capitalizing sentences and proper names/ for instance/ are entered 
by using the various case-shifting commands of the editor. 

WRITE HQDK. Options "L" and "t3» imply that you want to write/ 
i.e./ that the file will be modified. However/ if the file is not 
your own (not in connected directory)/ a file with the same name is 
created in your directory/ leaving the original file intact. 

READ-ONLY MODE. Option "R"/ for "Read-Only Mode"/ allows you to 
view the contents of the file/ but protects against accidental modifi- 
cation. In addition to safety, read-only mode Is considerably faster. 
Its use is recommended whenever you do not intend to write or modify 
a file. 
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USE OF 'CR' kHD 'ESC, DEFAULT VALUES. Some questions coae with 
a default option. The default is displayed to the left of the double 
slash "//*', and you can accept it by typing only 'CS' or 'ESC. To 
reject it, simply type your answer. TerBalnating an answer with 'ESC 
neans to use the default answers for all reaalning questions. A fast 
way to start is to confirm the file name with an 'ESC. 

USE OF "?'* AMD "*". Any question in the starting dialog can be 
answered by typing the question mark "?". The editor then prints a 
message explaining the available alternatives and repeats the ques- 
tion. Replying with "*" takes back to the first question allowing 
the review and changing of options. 

Qnce the file name and options are accepted, the first 23 lines 
of the file "FILEl" appear on the screen. If FILEl is a new file. 
It is perfectly safe to start typing and experimenting with the edi- 
tor. Straight typing should raise no major questions. Changing text 
that is already on the screen, however, requires knowledge of editor 
coBjmands. Most of this manual is devoted to describing these coa- 
mands, but tirst we concern ourselves with what is shown on the 
screen and how the keyboard is laid out. 



What Is Shown on the Screen 



WINDOSii. ¥ou can think of the screen as a window to your file. 
Up to 23 lines of the tile are shown at once. To view successive win- 
dows, type 'ESC followed by the letter "W". 

MESSAGE LINE. The topmost line (Line 0) is not part of the file 
but is Information about the file and the editor. It gives the page 
and line numbers of window line 1, current editing modes, and mes- 
sages from the editor. Possible editing mode letters are 

I insert mode, 

R read-only mode, 

L lowercase input mode, and 

U uppercase input mode. 

If the program was started according to the sample protocol above, the 
message line snould contain the following (TECs show a BOX character 
in place of the •»*»♦): 

****p^ j***L,i**** L ******* 

meaning that top of window is page I line 1, and keyboard input mode 
is lowercase mode. 

TEXT LINES, SPECIAL CHARACTERS. All text is displayed in upper 
case on TECs- Characters that have no graphic representation (i.e., 
control characters) are indicated by an all-briqht "BOX" character on 
TECs, '•*» on DAlAMEDIAs. The ESC is displayed as "$". 
*L 
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MARGINS km LONG LIl^ES. At each end of a text line there Is a 
colon "J" or an asterisk "*" indicating the edge of the Mindou. An 
"*" means that the line continues past the edge of the window. To 
demonstrate^ the line beloa has 94 characters: 

I '•#$%& '()*+,-./01234S6789:;<=>?@ABCDEFGHIJKLMN0PQRSTUVWX¥ZC\3*_*abcdefghlJklBno 

On your listing it might appear as two llnes^ but on the display the 
right end of the line is hidden. Initially the window width is 72 
(77 at SUMEX). You can set it to any value n fro» 1 to 78 (1 to 77 
for DATAMEDlAs) by using the "$$nX" coaroand. 

PAGE MARKS. In addition to genuine text lines^ a text file can 
contain page marks which are displayed as page «ark lines. Notice 
that the "P" of a page mark line is aligned with the colons of the left 
margin. Page marks can be inserted and deleted. No other editing of 
page mark lines is posslisle. 

INDICATOR LIMES. Equals sign "=" at left and right margins in- 
dicates an indicator line that is produced by the "$$=" coBiraand (ex- 
plained later on). 

END OF FILE. Letter "E" at left margin indicates end of file. 

CURSOR. There is one special underline called the cursor. Its 
function is to point. At any one ti»e the cursor points at a charac- 
ter, a word, a line, and a page. These are called the CURRENT char- 
acter/word/line/page, respectively. 



TEC and DATAMEDIA Keyboards 



The keyboards have a laain board, a 15-key pad to the right of the 
aain board, and one or two EDIT keys beside the space bar. DATAMEDlAs 
have additional keys above and to the left of the aain board. 

MAIN BOARD. The main board resembles the Kodel-33 Teletype key- 
board. It contains all the keys that are necessary for editing with 
TV-Edit. The additional keys are used to make editing more convenient, 

Most keys generate characters by theaselves (letters, numbers, 
space, carriage return, etc.). Five keys don't, but are held de- 
pressed while other characters are typed. They are: 

SHIFT The two shift keys resemble typewriter shift keys. 

However, on uppercase-only terninals (TECs) they are 
NOT used to generate selectively upper- and lowercase 
letters. 
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CTRL Control key (two on DATAHEDIAs). Causes non-printing 
control characters to be generated. Some control 
characters/ e.g., (CTRL)-I for TAB, have predefined 
meanings, others can be given meanings by the user 
(see section on Command Strings). 
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EDIT One (orange key) on TECs, tMO on DATAMEOlAs. Used 
for generating editing commands. 

REPEAT For repeated generation of a character. 

Several of the "regular" keys deserve mention: 

ESC Escape, referred to also as "ftLT MODE" ("ENTER" on 
(ALT MODE) some keyboaras). Represented in this manual by 
(ENTER) "S". It tells the editor program that an editing 
cofiiffland is about to be typed. 

CR Carriage Return signifies end ot line. 
(RETURN) 

LF Line Feed moves cursor down. 

DEL Delete key. Also called "ROBOOT". Its main function 
(RUBQUT) in tlie editor is backspacing. 

BREAK The Break key has no function in the editor. 

TAB On TECs you might be fooled into believing that TAB 
is (SHIFT)-I. Actually it is (CTHL)-I.— Both key- 
•- boards hov€> also a dedicated "TAB key. 

On TECs the underline (left arroM in 1965 ASCII) is 
generated by (SHIFT )-0 (the letter "0"). The key 
caps in no way indicate this fact. — Both keyboards 
have also a dedicated "_" key. 



"EXTRA" KEVS of the TEC keyboard (15-KEY PAD). The 5 x 3 pad 
on the right can be used tor typing the characters shown in Table 1. 
These characters can, of course, be typed on the main board, but 
there you nave to use the SHIFT or CTRL keys tor them. 

TABLE 1. TEC 15-Key Pad 

TAB _ CftLL 

C \ 3 

( * ) 

< = > 

(1) LF HOLD 

note: (1) SHIFI/SHIFT LOCK in TEC version of TV-Edit. 

TECHNICAL NOTE: These keys actually generate lowercase letters that 
are TEC display hardware commands. They are translated into the char- 
acters shown in Table 1 by IHSSS TENEX and the T¥-Edlt program. 
*L 
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"EXTRA" KEViJ of the DATAMEDIA keyboard. The 15-key pad on the 
right generates characters as labeled on the key caps. The 5-key ver- 
tical coluan on the left generates the following control characters 
(from top to bottoia): "L/ "X/ "If **/ and *A, octal values 14^ 
34^ 35^ 36/ and I, respectively. The 7 keys in the top ro« are labeled 
according to their eftect on the teraiinal. DPLX and TAPE keys are 
local only# and they control the FULL DUPLEX and TAPE lights. M3TR 
CLEAR/ CLEAR, ROLL/ and UNLOCK keys transmit control characters to the 
PDP-10. If the terminal is in half duplex (FULL DUPLEX light is off 
--use the DPLX key to turn it on or off)/ these keys also perform the 
indicated control functions. 

In norroal use (TTY nsode) ROLL and FULL DUPLEX lights should be 
on/ and TAPE and I/D lights should be off. While editing with TV-Edit/ 
FULL DUPLEX light must be on and TAPE light jBUSt be off. 



Editor Commands, Notation 



The general rule of TV-Sdit is that straight typing goes to the 
text file as such, unless you are in read-only nsode, in uhich case 
straight typing is ignored. To do anything else, you have to type 
EDITOR COMMANDS. These conmands allou you to Bove the cursor within 
the current window (pointing), view the file through successive win- 
dows/ search for characters and words, insert, delete, replace, and 
rearrange text (if in write node), and, of course, finish the edit 
and save your work on a disk file. 

There are two ways to tell the editor that you are typing a 
COMMAND instead of ordinary text: 

1. by typing an 'ESC and then the comoiand, or 

2- by typing the cowmand while depressing the EDIT key. 

The first method always works. The second is nore convenient, but 
for some cowKands »ust be complemented by the first. 

NOTATION. Suppose you are editing an old tile, have read the 
current window, and now want to see the next window and then proceed 
reading the file froia the beginning of page 3. Vou should type: 

'ESC «i or (EDIT)-W to see the next window, 

'ESC 3G or (EDIT)-3G to go to page 3. 
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'ESC W means to type the ESC key and then type the letter •»«"> 
(EDIT)-« means to hold down the EDIT key while typing "«"• In the 
rest of this manual typing 'ESC (i.e., the ALT MODE) is indicated 
by the dollar sign "$"« Typing soaething with the EDIT key down is 
indicated by enclosing that something in brackets "C" and "3". Thus 
the above two coicaands will henceforth be written as: 

$V or Cii3 

$3G or C3GJ 
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It should be pointed out that 

$3G $3$G t3G3 and C33G 

are typed differently but njean the same thing in the editor. 

In general, TV-Edit commands can be thought of as one-letter 
commands (more precisely, one-character comroands) that can take AR- 
GOMENTS (fflodifiers). Arguments BEFORE the coiwand letter usually 
give a (repeat) COUI^T; arguments AFTER the command letter specify a 
TARGET. If the count is oiaitted, 1 is assumed (exceptions: "$G" and 
"$W" commands), Rxaaple: 

C3SA3 

is a command to search the current line for the letter "A" (the cur- 
sor moves to the right to the third "A"; "3" is the count arguaent, 
"S" the cowiaand letter, and "A" the target. 

DOUBLE ESC. Typing two ESCs before the ccraBiand neans one of two 
things depending on the coowand: Either 

(a) a huge count is to be used, or 

(b) a different function is to be performed. 

An exawple of the former is »»$$G" or *'C$G3" which takes to end of the 
file; of the latter, »V$$F« for finish ("$F" does nothing). Commands 
for which the double ESC option signifies a different coamand are: 

=, F, H, N, X, and Y. 

These commands are explained later on. 

If you start the command with two ESCs for a huge count, but 
continue with an honest count, the count given will be used. Thus, 
"$$3G" goes to page 3. Double ESC followed by count makes the count 
sticky for the following "again" command (explained later). 

FURTHER notation: 

'CR' Refers to typing the Carriage Return key. 

'LF' Line Feed key. 

'DEL' DELETE key or RUBOUT. 

•SPACE' Space bar. 

(CTKL)-A Control characters are typed with the aid of the 
CTRL-A CONTROL key (while held depressed). Shown here 
*A are three "standard" ways of indicating CTRL-A. 

<...> Brokets are sometimes used to enclose a descrip- 
tion of a mandatory argument. 
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(...) Parentheses are soinetiffles used to enclose optional 

arguaients or inf oraiatlon. 



«i It 

. . • 



Double quotes are used Inside text to deliait a cora- 
mand or a string. 



WARhING: Many of the characters used in the notation are also 
T¥-Edlt coiDinand characters (e.g./ 'g (,, ), <, >, *# ", -)• He rely 
on the alertness and good niill of the reader in deciphering the no- 
tation. 



Finishing/ Save-and-Continue 



There are two Hays (apart from a system crash) to get out of TV- 
Edit: an orderly finish and a panicky exit. Unless you have a good 
reason for doing otherwise/ you should finish by giving the command 

$$F — Finish 

(that's two ESCS/ ALT MODES/ If you please, followed by "F"). The 
program clears the screen and prints the message: ".VQU.HILL.HAVB 
•TO. WAIT..". The uait Is rather short for read-only node/ longer if 
you were actually editing (in write node). Once finished/ the editor 
program is best restarted by "CONTINUE". 

The panic exit is via (CTRL)-C system call. If you type the 
*C by accident and want to return to the editor/ do a "CONTINUE" 
and follow it with "$$N" to refresh the screen. The ""C" exit is 
of minor consequence if you are in read-only aode/ but if you are 
actually editing a file/ you will lose some of the work of the cur- 
rent editing session. 

While editing your file/ the edited text is in a temporary 
state and becomes permanent only when the edit is finished. A sound 
practice/ therefore/ is for you to save your work every so often. 
This is done by 

$F — save-and-continue. 
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3. VIEWING AND POINTING 



Viewing a File 

In read-only mode^ looking at your text and pointing are about 
the only things you can do (it is also possible to "lift" text froa 
a read-only file for copying it to another file). In sodifying a file, 
one constantly performs the functions of viewing and pointing. This 
section describes the most important commands for vieuing, the next 
section for pointing. You should try theai out as they are introduced. 

W — Window 

CWl Display the next window. 

C-fe/3 Display the previous window. 

Z3M1 Scroll 3 lines. 

G — Go 

LGl Go to (and display the beginning of) next page- 

C3GJ Go to page 3, line 1. 

C3.45G1 Go to page 3/ line 45. 

C.G3 Go to current page, line 1. 

C.45GJ Go to current page, line 45. 

$$G Go to end of file. 

eg] Go to the next place as given by the place list. 

note: The place list is accepted by the editor as a 
reply to the "(Page. Line)" request when starting to edit. 
It can be either typed in or read froia a 'Inaae-ext.PL' 
file (created by the SEARCH program). 

X/ Y — set window width, height 

$S11X Hake the window 11 colunsns wide. 
S$11Y Make the window 11 lines high. 

The "-W" and "G" commands can cause the nessage ".YOU. HILL 
•HAVE.TO.WAIT..." to appear. While waiting, you will notice that one 
of the numbers on the message line keeps counting. It counts page 
narks as they leave the program's temporary storage area. If 5 is 
shown on the message line and you type "C4G3", you will have to wait 
while the program does a "file wraparound" (whatever that might be). 
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Moving the Cursor (Pointing) 



To change something in your file you must tirst point at that 
sofflething. The cursor does the pointing, and there are a number of 
commands for moving the cursor. 

COMMANDS THAT MOVE THE CURSOR IRRESPECTIVE OF THE TEXT 
(free cursor movement) 

< — left 

C<1 Hove cursor left 1 position. 

i:22<l Move left 22 positions. 

SS< Move to left margin, 

ZS<2 Sane as •»$$<". 

> — right 

C>3 Move cursor right 1 position. 
C22>3 Move right 22 positions. 
CS>3 Move to right margin. 



— up 
C(n)*3 Move cursor up a line (n lines), to top line at most. 

\/ LF — down 

C(n)\3 Move do«n (n) line(s), to bottom line at most. 
'LF' Move down a line. 



K, ¥ — absolute X, ¥ 

C55X3 Hove cursor to column 55 on the current line, 
Cll¥3 Move cursor to line 11 on the current column. 



COMMANDS THAT MOVE THE CURSOR WITH RESPECT TO THE TEXT 
(restricted cursor moveBsent) 



SPACE — right/ by characters 

C'SPACE'J Point to the next character (the one on the right) 

CS'SPACE'J Point to the 5th character (on the right). 

C$'SPAC£'J Point to end of line. 
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DEL, RHBOUT — left, by characters, 

or up, by lines 

'DEL' Point to the previous character. 

C'DEL'3 Same as 'DFL' alone, except that at beginning of 

line moves cursor up. 
C5'DEL'3 Point to the Sth character on the left or 5th line 

above. 
C$'DEL'3 Point to the beginning of current line or page. 



) — right, by words 

C)3 Point to beginning of next word. 

C3)3 Point to beginning of 3rcl word on the right. 



( — left, by words 

C(l Point to the beginning of previous word. 

C5(l Point to the beginning of Sth word on the left, 



CR — down (or up), by lines 

'CR' Point to beginning of next line. Start a new line 

if at end of file and in write Rode. 

C'CR'J Same as 'CR' alone (no new line at end of file). 

C12'CR'3 Point to beginning of 12th line down. 

CO'CR':i Point to beginning of current line. 

Z-'CR'l Point to beginning of previous line. 

C$'CR'3 Point to page mark at end of current page. 

C$-'CR'3 Point to page mark at beginning of current page. 



The "<", ">", »*", "\", ")", ana •'(" coBwands can be typed 
on the 5x3 pad with the aid of the EDIT key. The keys are laid 
out to remind you of the functions. 

The coiriEands in the first group ("<", ">•*, •'*", "X") observe 
the window boundaries but NOT end of line and page narks. The 
coDifflands in the second group ('SPACE', "(•', ")", 'DEL', 'CR') ob- 
serve end of line and page laarks (i.e., text) but NOT window bound- 
aries. Both respect the end of file ("X" and "¥" commands don't) - 

Pointing by searching is discussed later. 
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3. MRITING AND MODIFYING 



Editing an old file should be attempted only after sooe knowledge 
of the editor lias been acquired by "editing" In read-only mode and by 
writing on a temporary (nea) file. It is possible to lose text acci- 
dentally^ but if noticed right away it is usually possible to recover 
lost text or to "panic" exit and retain the old file. Some care is 
advisable/ but one need not be overly concerned. 



Writing and Gvertypiiig 



Straight typing goes to the file as such. Things to notice in 
straight typing are: 

OVERTYPING. If you are pointing to a character and type, the 
new character replaces the old. Exceptions: 

1. TABS never replace other characters but are inserted in 
front of them. 

2. Regular characters never replace TABs (the last TAB). The 
TAB is pushed to the right. 

3. Insert laode/ which is explained later. 

LUNG LINES. If you attempt to type past the right nargin, the 
current line is shifted to the left so that your typing position is 
always visible. An attempt to enter a really long line (more than 
132 characters) results in the editor's request to break that line- 
When the cursor leaves a long left-shifted line, the line gets shift" 
ed back. 



Deleting 

The basic comioands for DELETING are $D and $K. 

D 'CR' — Delete lines 

CD'CR'3 Delete the current line. 

CSD'CR'J Delete 5 lines starting from the current line. 

C$D'CR'3 Delete down to botton of window or next page mark, 

whichever cooes first. 
C-3D'CR'l Delete current line and the 2 lines above. 
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D 'DEL' — Delete words 



C(n)D'DEL'3 Delete the current word (and n - 1 following words). 
C-5D'DEL'3 Delete the current word and 4 preceding words. 



D <letter> — Delete characters 

K — delete (Kill) characters 

C0D3 Delete current character (the second "D" could be 

replaced by any letter). 
CK3 Saffle as "CDD3". This is the preferred way to delete 

characters; you need to type only one letter. 
C11K3 Delete 11 characters. 
C$K3 Delete rest of current line. 
C-(n)K3 Delete (n) characters LEFT of the current character. 

note: Deleting up to a target character is often the most 
efficient way of deleting. This will be explained later. 



inserting. Insert Mode 



The basic command for INSERTING is $1. Page narks are insert- 
ed with the "P" coffimand. 



I — enter Insert mode 

INSERT MODE. The "I" coawand leaves the editor in insert mode. 
This condition is indicated by a blinking "I" on the message line. 
Once in insert mode, any text typed is inserted in the text instead 
of overtyping old text. To leave insert »ode/ type any pointing 
command. 

Things to notice about typing in insert mode: 

(a) DEL (RUBOOT key) without the EDIT key deletes the character 
to the left of the cursor (the one last inserted). 

(b) CR (without the EDIT key) inserts a blank line between the 
current line and the one below it. An attempt to break a line into 
two lines by inserting a 'CR' falls. Use the "B" command for that 
(explained later). 

I 'CR' — Insert lines 
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CI'CR'3 insert a blank line above the current llne- 
C5I'CR'3 Push current line down 5 lines and insert 5 blank 

lines. 
C$I'CR'J Insert as aiany blank lines as there are lines from 

current line to bottora oi screen. 
C-3i'CR'l Push current line up 3 lines and insert 3 blank lines. 
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I 'DEL' — Insert words 
CI'DEL'J (Prepare to) insert text in front of the current word, 

P — insert a Page mark 
CP3 Insert a page mark above the current line. 



Page Marks 

Page isarks serve several useful functions: 

(a) With the "G" command you can go quickly to the general area 
where you fciant to edit. 

(b) Tne page marks liKit the extent of the text-sensitive com- 
aands 'CR', 'DEL', D'CR', S'CR', Z'CR', and 'quote'. They can some- 
times be utilized for terminating string execution. ("S", "Z", and 
'quote' cofflaiands and string execution are explained later). 

(c) In listing a file, page mark starts a new page. 

Page rearks are inserted with the "P" comwand, deleted with 
the "D'CH"' comicand. 



By now we have introduced enough coawands to allow you to do 
useful editing and to develop a feel for the editor. Me would^ in 
fact, discourage the beginner from reading the rest of the manual 
until he has used the editor for a while. 

Once you feel that the editor program ought to do more for you, 
you should read ahead. Until then it aight suffice to know that 
there are conmands that search for characters and words, break a line 
in two. Join two consecutive lines, recover deleted lines and words 
either at the spot where they were deleted or elsewhere on your file, 
copy and wove lines and words within the window, and others. The 
full power of a TV-Edit is utilized only via the mechanism of (com- 
aand) strings. 



**** END QF BEGINNER'S MANUAL **** 
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4, ¥mE POWER TO YOU 



The rest of this manual contains cowmands and information that 
is helpful once you are soaeMhat familiar with T¥-£dit. 



Aborting 



The need for emergency exit arises in several uays: 

(a) You have partially typed in a coamand but decide not to exe- 
cute the command after all (you have already typed "$55" when you had 
Intended to type "S.55G"). 

(b) A coffljnand (or command string) that is being executed seems 
to be doing more than you originally intended. 

The Hay out of the fix is: 

*L — Leap, abort 

(CTRL)-L Abort the coniBand (or coamand string) currently 

being input or executed. Flush tlY input buffer. 

NOTE: Typing "**€" followed by "REE 'CR'" has a similar 
effect, but can also have undesirable side effects. It 
is recommended only in an emergency, when the *L fails. 



Suppress Output 



There are times when you do not want to wait for the whole win- 
dow to be printed out (especially if you are connected to the system 
over a slow communications line). You can interrupt the display gene- 
ration by typing 

"0 — suppress Output (shut up) 

Every other (CTKL)-u stops window generation, every other starts it 
up again. Editing with self-calling strings can at times be speeded 
up considerably by letting the editor run "in the dark". 

*L 
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Repeating the Last Command 



A — Again 

Lkl Repeat the last conmand but use count 1. 
C5AJ Repeat the last conmand using count b. 

S$A Pepaat the last conraand the way it uas originally given 
(true for most coamands). 

The "A" cofflBiand is a most versatile coBffland since it can be 
used for repeating almost any other comnand. So«e comaands might be 
just as easiiy typed themselves again^ but others are easier to re- 
peat using the "A" coinmand (for target connands it eliainates the 
need to respecify the target). 

In executing a comnjand that requires a target^ you should first 
give a count that gets you almost there# and then finish up with the 
"A" command. 

STICKY COUNT. Froo the example above you might have noticed 
that the original count is replaced by 1 when the command is repeat- 
ed. To make the original count sticky type the original command with 
two ESCs. For example/ "C$2D'CR'3" deletes two lines, "CAJ" thereaf- 
ter deletes two lines instead of one. 

The "again" command has not yet been developed to its fullest, 
but even in its current form is quite worthy of your consideration- 



Obtaining Information 



Some information about the state of the editor is continually 
displayed on the message line. If the text in the file contains con- 
trol characters (and lowercase for TECs), additional means are needed 
for determining the exact contents of a line of text. 

= — fchat's the character, where are we 
C=3 Print on message line the following (an example): 
%A='141...X=59...P.L=20.38-..1?.45.. FIL£1.;1 

i.e., 

(a) current character is lowercase "A" ("%A" for lower- 
case A, "*A" tor (CTRL)-A), and its octal value is 
141; 

(b) cursor is at column 59 of page 20 line 38; 

(c) page 17 line 45 is the first line in the temporary 
memory storage (that's how far you can back up with- 
out having to wait); and 

(c) the name of the file is "FILEl.;!". 
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$$= Inuicate, above the current line^ the exact contents (upper- 
case, lOMercasey- control characters) of the current line* 
The tollowing symbols are used on the indicator line: 

Indicator 

character Real character 

space or regular punctuation (40-100,133-137) 
(TECs only) uppercase letter (101-132) 
(TECs only) lowercase letter (141-172) 
! (TECs only) lowercase punctuation (140,173-176) 
BOX or * DEL, RUROOT (177) 
: TAB (11) 
left-L or \ end of line (12,15) 

@ NULL character, CTRL-8 (0) 

A...Z CTSL-A,,,.,CTRL-Z (1-32) 

t..._ CTRL-C,...,CTRL-_ (33-37) 

(ESC is CTRL-C, TENEX EOL is CTRL-_) 

The indicator line itself is indicated by tne equals sign "=" 
at left and right isargins in place of ":" or "*'•. It overprints the 
line above the current line, but does not affect your file in any uay. 
"$-fl" lets you vieu the iuessed-up line again. 

"CA3" after an "=" coamand indicates the NEXT character or line. 

U — refresh screen ("N" for no-op) 

C4N3 Refresh (reprint) 4 lines starting from current line. 

C-4N3 Refresh 4 lines above the current line. 

CONJ Refresh line (the message line). 

t$Ml Refresh the entire screen. 



Upper and Lower Case 



Except for the ".L" and ".0" commands for converting old text to 
louer or upper case, this and the next section are primarily of inter- 



est to TEC users. 

The **=" conmand allows you to see on an uppercase-only terminal 

whether a character in the file is in upper or lower case. Here we 

introduce coamands for ENTERING text in either upper or lower case, 

and for CHANGIfiG the case shift of text that already is in the file. 

An "L" or "U" on the message line tells whether the text being 
typed is to be entered in upper or lower case. In starting the edit, 
one is selected as the primary input case. Regardless of the priaary 
case, the current input case can be either "L*' or "U" for the duration 
of one or more input characters. When the current case differs fro« 
the primary case, the current case letter on the message line blinks. 
This is the program's way of reminding you that you are entering text 
in the "wrong" (non-primary) case. 
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H — shift 



CH3 Shift (froffl "L" to "U" or from "U" to "L") for the next 
input character, 

NOTE: On TECs the preferred way to shift for one 
character is to type the lOMer-lett key of the 5 x 3 
pad by itself. On DATAMEDIAs use the SHIFT key. 

C8H3 ihift next 8 input characters (or until end of line). 

S$H Shift lock: Permanently shift the case. 

MOTE: On TECs the preferred way to shitt-iock is to 
type the lower-left key of the 5x3 pad while the EDIT 
key is depressed. On DATAMEDIAs use the LOCK key. 

U/ L — enter in Upper/Lower case 

i:(n)Ujl Enter next (n) input (s) in upper case. 
C(n)L3 Enter next (n) Input(s) in lower case. 

The effect of these two commands is terroinated by end of line. 

.Uy .L — convert to Upper/Lower case 

C(n>.U3 Convert (next n) character(s) to upper case. 
C(n).L]l Convert (next n) character(s) to lower case. 



Lowercase Punctuation on Uppercase-Only Terminals (TECs): *C|>" 



The reason for calling these characters "lowercase punctuation" 
is that they do not appear on uppercase-only terminals. Refer to 
Table 2 below to see how they are generated and displayed. 





TABLE 2. "Lowercase 


i Punctuation" on 


TECs 






Octal 


Typed 


Displayed 


Otherwise 




Character 


value 


as(*) 


at 


input 


displayed 










time as 


as 


n 


accent grave 


140 


% 




* 


@ 


C 


left brace 


173 


L 




< 


C 


i 


vertical bar 


174 


\ 




1 


\ 


} 


right brace 


175 


1 




> 


] 


«v 


tilde 


176 


4«t 




— 


A 



note: (*) To enter "lowercase punctuation" troa the keyboard, 
the case shift indicator on the message line Bust be 
BLINKING, i.e., with a lowercase tile you Must be in 
upper case and with an uppercase file in lower case. 
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IliPUT TIME DISPLAY. Ordinarily, these characters are displayed 
as their uppercase equivalents, However, at input time they are not 
displayed as the corresponding uppercase characters, but as other 
characters that resemble the lOMercase characters that they really 
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are. Hopefully this drays your attention to the fact that what goes 
in the file isn't exactly what you typed nor what you see on the 
screen. 

In character and string search^ the uppercase equivalents are 
to be typed as targets (just as is the case with louercase letters). 
You might be aaused when searching for these characters on a newly 
entered line. 

The ".U" coffiraand does NOT convert lowercase punctuation char- 
acters in your file to the corresponding uppercase characters. 



Entering Arbitrary Characters 



' — ASCII value In octal 

C'333'Cfi' Enter the ASCII character whose value is 33 (octal) 
in the tile. 

NOTE: The octal number is accepted on the aessage line in 
the same way as string search argument is. See "T" command. 



Searching 

Several comiaands let you specify a target character or string. 
The editor program will then find the target/ and depending on the 
command/ will either point to it or delete text up to it- In aany 
instances the target coriaands/ coupled with the "again" conmand/ pro- 
vide the most efficient aeans for pointing and deleting. 

No distinction between upper and lower case is made in searching. 

Search that does not find terninates string execution. The sig- 
nificance of this is discussed later. 

In the examples below, the letter "A" serves as an example. It 
could be replaced by any character other than 'CK' or 'DEL'. 

S — character Search 

CSA3 Point to the next "A" on the current line. 

C3SA1 Point to the 3rd "A" (on the right). 

C-3SAJ Point to the 3rd "A" on the left of the current 
character. 

S 'DliL' — word Searcli 
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CSdO'PEL'AJ Point to the 1st (nth) word that is to the right 

of the current word and starts ulth an "A". 

C-S2'DEL'A3 Point to the 2nd word starting with "A" that is to 
the left of the current Hord. 
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S 'CR' — line Search 



CS'CR'AJ Point to tne 1st line starting with "A" that is 

below the current line, A line starts with "A" 
If the first visible character is "A". SPACE and 
TAB are invisible characters, 

C-3s'CR'AJ Point to the 3rd line starting uith "A" that is 

above the current line. 



T <string> — string search 

C100T3THE'CR' Scan up to 100 LINES starting from current cursor 

jposition (+1) and point to the first occurrence of 
the word "THE". 

$$T£MD'CR' Scan tor the first "END" that is to the right of 

or below the current character. 

NOTE: The count refers to the maximuffl number of LINES that 
are to be scanned. The command is accepted in a standard 
fasuion up to^ and including, the command letter "T". The 
string argument is accepted on the message line, where 'DEL' 
can be used for editing the argument string (it deletes from 
the rear). The 'CR' that terminates the string argument is 
displayed as a left-L or "\". String search command that 
is given without a target (with empty target string) uses 
the most recent string target: 

$$T'CR' Search for the next occurrence of the string that 

was last searched for. 



Search-and-Delete 



Z — delete (Zap) characters 

CZA3 Delete characters on the right up to the 1st "A". 

C-3ZA3 Delete characters on the left up to and including 

the 3rd "A". 



Z 'DEL' — delete (lap) words 

CZ'DEL'A3 Delete words (on the right) up to the 1st start- 
ing with "A". 

C-3Z'DEL'A3 Delete words (on the left) up to and including the 

3rd one starting with "A". 

Z 'CR' — delete (Zap) lines 

CZ'CR'Al Delete lines (downwards) up to the 1st starting 

with "A". 
C-3Z'CR'AJ Delete lines (upwards) up to and including the 3rd 

starting with "A". 
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RecoveriBg 



TV-Edit is forgiving. If you accidentally delete text/ you can 
recover it by "oopsing" right after the deletion occurred (no inter- 
vening cofflioands) or by recovering it later/ provided that you have not 
deleted uiore than about a uindoufull in the intervening tine. It Is 
always possible to "oops" what was Just deleted. 

— Oops 

C03 Undo the last connand provided It was a delete. If 

it was not a delete but you have been editing a line/ 
restore the line to what it was when you started 
editing it. 

R 'DEL' — Recover words 

C(n)R'DEL'3 Recover (n) reost recently deleted word(s) and insert 

on the current line. 
$$R'DEL' Recover the words deleted with the last word-delete 

coiamand. Observes word-delete count and direction. 

R 'CR* — Recover lines 

C(n)R'CR'3 Recover (n) most recently deleted line(s) and insert 

above the current line. Will undo "C(n)D'CR'3". 
C-3R'CR'3 Recover three most recently deleted lines and insert 

them below the current line. Will undo "i:-3D'CR'3". 
$$R'CR' Recovers the lines deleted by the last line-delete 

comroand the best It can. Observes last line-delete 

count and direction (up or down). 

NOTE; The maxlffiura number of lines recovered by one "R" 
coBiiiiand is restricted to the number of lines between the 
current line and the top or bottoo of window, depending 
on the direction of the cossmand. It is therefore at 
times necessary to execute the coiBmand more than once to 
get all the saved lines (fflaxi«uin of 24) back in the file. 

The editor "reraeaibers" the number of items (words or lines) last 
deleted/ and the direction of deleting. The double ESC version of 
the "R" cofflKand uses this infornation to limit the extent of the re- 
covered material. You can override the internal settings by giving 
your own sign and count with the command. 

The word and line recovery oechanisas are independent of each 
other. No corresponding character recovery mechanisra exists. 



/ ^ 
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Breaking and Joining of Lines 



ca] 



a — Break a line 
Cut current line into two at where the cursor Is. 



A yay to insert blank lines without going to insert wode is to 
do a "C83" «hiie the cursor is at the beginning of a line. 



CJ3 
C-J3 



J — Join two lines 

Join current line to the one below. 
Join current line to the one above. 



Moving Text 



Breaking and joining of lines is one foca of rearranging. How- 
ever/ it does not allow you to change the order of the text. Delet- 
ing lines or words and then recovering them someplace else wakes 
reordering possible. Here are other coanands for reordering^ as well 
as for producing duplicate copies ot words and lines. Strings (see 
below) provide still another method of moving text. 

M 'CR', M 'DEL' ~ Move a line, «ove a word 

C(n)M'CH'3 Move the current line down over one line (n lines). 

This coMiand never moves past a page nark/ or bottoa 

(or top) ot window. 

C-2M'DEL'J Move current word left over two words. 



C 'CR', C 'DSL' — Copy lines. Copy words 

C5C'CH'J Duplicate this and next 4 lines. 

The number of lines copied is restricted by a page 
mark or bottom (or top if "-C") of window. 

CC'DEL'3 Duplicate the current word. 



.0 'CR', .D 'DEL' — "reroefflber" lines/words 



C.D'CR'3 

i:-3.D'Cfi'3 

CS.D'DEL'J 



Save a copy of the current line for later recovering 
Save copies of this and two preceding lines. 
Save copies of words from here to end of line- 
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note: The ".0" coBiaand uses the same mechanisins as the 
"D" command for saving lines or words* They are recovered 
by the appropriate "R" commands. In addition to leaving 
the file intact (only the cursor noves), the ".D" cowmand 
causes internal counting whose function Is to hang onto all 
the lines (words) that have been stored with the corre- 
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spondlng ".0" coiaraancl or subsequent delete commands. When 
the internal storage is full, a imessage asking you to re- 
trieve deleted lines (words) will appear. A line (word) 
once stored using the ".D" command has to be retrieved 
sooner or later to get rid of that oiessage and allow un- 
restricted deletincf. 



Command Strings (Macros) 



TV-Edit has the means for storing a sequence of typed com«ands 
and text as a string in such a way that at sorae later time you can 
reexecute the sequence by typing Just one character/ the string ID. 
Strings allow you to design your own super conoands. 

A string in TV-Edit consists of the string ID character^ also 
called the name of the string or the string call character^ fol- 
lowed by the effective string (the part that gets executed). Most 
control characters are valid string ID characters. The following 
ones are not: "§, **€, *!/ ^J, "L, *H/ "0/ "7, and *C. The 
effective string may contain string calls (names of other strings), 
including calls of itself. 

Some commands are restricted so as to work only if entered from 
the keyboard. An attempt to execute such com&ands under string con- 
trol results in (orderly) string execution abort/ and a message to 
that effect will be displayed. This is the editor program's way of 
preventing excessive damage by runaway strings. 

In addition to Illegal commands/ string execution abort can be 
caused by other internal conditions/ for example: 

(a) Execution has been under string control for the last 1000 
"Input" characters. This is a precaution against "looping" strings. 

(t>) Search fails. This makes automatic search-substitute fea- 
sible. It is safe to define a string "*QCSA38'D£L'*Q"/ where *Q is 
the string ID) and use it to replace all "A"s by "B"s on a line. 
String execution terminates when the cursor reaches end of line and 
fails to find more "A"s. 

(c) String "attempts" to delete more lines (words) than can be 
recovered. It is always possible to undelete the lines (words) de- 
leted by the string just executed. No such precaution against char- 
acter deletion exists. 

(d) String "attempts" to delete a page mark or write on a page 
mark. A useful device for stopping self-calling strings. 

/ — begin or end string definition 
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C/l*QABCC/3 Define the string "*QABC"y (CTRL)-Q is the string 
ID, the effective string is "ABC»«. This is the 
standard way of defining strings. 

C/3*WX¥2CA3 Define the string "*WX¥Z*l(il". The first (CTRL)-« 

is the string ID^ the second (last) is a self-call 



Page 28 

due to terminating the string definition with an 
"CA3" instead of "C/3". The effective string is 
"XYZ**". 

After typing the initial "C/3", the message ".TYPE. STRING. ID." 
appears. After you type it (say, *Q)/ the message changes to ".DE- 
FINING..". It disappears as soon as you type the terminating "C/3" 
or "CA3", or the *L. 

If the ID you type is invalid or already defined/ you will be 
properly warned and given a chance to try again. 

UNDEFINIMG. If you type the tereinating "C/3" right after the 
string ID has i>een accepted/ the ID is freed (string undefined). An- 
other Hay to undefine a string is to abort (with *L) while defining 
a string. All strings can be undefined at once using the "$$.R0" 
command explained further down. 

R <string ID> — Retrieve a string 
CRl^Q ifirites (inserts) the string for "G in your file. 



II ._ 



define a string from tile 



C"3 Define a string: Take the current character as string ID/ 
the ifflfljediately following text/ up to "$/" or page mark/ 
as the effective string. 

The "R<ID>" coraaand saves strings on the file the way 'quote' 
command wants to see them. 

MOVING TEXT. The strings provide one more method oi copying and 
moving text. You can use the 'double quote' cofflmand to store up to 
a Hindowfull of text "under" a control character/ and retrieve it 
with the "R" command (or by entering insert mode and typing the con- 
trol character — risky if the text contains control characters which 
are string calls). After retrieving/ some clean-up might be neces- 
sary. To avoid overflowing the SAIL string space (and blowing up the 
editor)/ store only few pages of text under control characters at 
once/ and "undefine" the control characters as soon as you have re- 
trieved the text you want- 
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Saving and Loading of Sets of Strings 



Currently defined strings form a set. File 'TV-STRINGS.PINAP' 
in your directory is for storing sets of strings. Sets in the string 
file are identified by tne letters A#...,Z. The letters refer to 
lENEX pages of the file (letter "A" to page 101 octal, etc.). 

The set in fflensory at the time of finish is referred to as the 
MOST RECENT SRT, and is automatically stored on page of the string 
file when finishing, and loaded uhen starting the editor. This pro- 
vides continuity fronj one editing session to the next. 
*L 
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• D <letter> — save (Duiap) strings 



$$.Dx Save current strings on page x of T¥-STRIJJGS.PMAP. 
$$,D. Save current strings on a "letter" page last specified 
during this editing session. 

note: The set in BieiBory REPLACES the designated set in 
the string file- If the set in nenory Is empty (as a 
result of "$$.R0", see below), the string tile page in 
question is deleted. 

.P <letter> — load (Read) strings 

$$.Rx Load (merge) strings from page x of the string file. 
$$.R. Load strings last specified by a letter during the 

current editing session. 
$$.R0 Clear strings from neaiory. 

note: The set in the file Is MERGED to the set in meaory. 
Thus a string in meiaory is redefined only if it is defined 
in the set being loaded froo file. 

If X is not a letter (non-0 digit, for Instance), the most 
recent set is assuiced. 
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5. WiiAl HAPPENS TO ¥CUR DlkECTORV' AND FILES 



In its current form TV-Edit uses two files for yrite-node edit- 
ing# OLD and NESd* The old tile is the one you specify at the be- 
ginning of edit. Let it be "FILEl.A". The editor creates a new file 
and gives it the name "#FILF1-A.TV»'. Mhen the message ".YOU. WILL 
.HAVE. TO. MAIL. ." appears, file "tFILEl-A.TV" is closed and holds 
the updated file. It is renamed to "FILEl.A", and the old "FlLEl.A" 
vanishes. Failure to rename "iFILEl-A.TV" to "FILEl.A" does not 
mean that you have lost your work. It is there, but under a new narae. 

If an editing session is aborted either by *C system call or 

by a system crash, the "Iname-ext.TV" file contains the beginning of 

the new file. Use TVFIX and TMEfiGE programs If you want to recover 
the work from the aborted session. 

WARNING: If you switch betaeen SOS and TV-Edit, the SOS line 
nunber are not displayed. If you specify read-only mode, they of 
course stay intact in your tile, but they vanish if you edit in write 
mode. Also, BASIC line numbers are of the disappearing variety. 

-L 
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6. IN CASE OF TROUBLE 



1. MESSED-aP SCREEl^. Type $$N to refresh. 

2. RUNJi5ilAY CURSOR. Cursor is off the main screen and every coa- 
mand seeias to just ring the bell. Type 

C1X1¥3 

to get cursor to beginning of line 1. 

3. UUiiAMkY PROGRAM. Try "L first. It that fails, type 

*C to stop the program. Once stopped, type 

REE 'CR' for REENTER, to get back to the editor, 
$$N to refresh the screen. 

If that fails, type *C again and give up. You lose. 

4. FILE "naiae.ext" LOST. Check your directory for the file 

tnaiae-ext.TV 

It possibly is the updated file. Run the progran TVFIX, specify 
file "#nanie-ext.TV", and check what is in the fiie (use Read-only 
node). Then either merge (use TMERGE) file "#naiae-ext.TV" to file 
"name.ext" or rename "#nair.e-ext.TV" to "nasae.ext". 

5. You are typing to the EXEC instead of the editor. You (acci- 
dentally) typed ^C. If you want to save your editing, type 

COMT 'CR' to continue, 

$$N to refresh the screen. 

6. MYSTERIOUS MESSAGES. Some messages are there to help you, 
others are for debugging the editor program. The latter are of the 
form: 

cryptic name: cryptic story 

tfhere the naae is a name of a procedure, and the story a description 
of the error condition. These debugging messages are accompanied by 
long ringing of the bell. Two are known to surface from time to tine! 
"SETXY: empty uLU" ahen starting to edit an old file that is of zero 
length, and "LGPTAIL: TS > MAXS INITIALLY" when the old file contains 
lines longer than 132 characters. Other debugging messages should be 
brought to the attention of the author. It ought to be safe to con- 
tinue after such messages. 
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APPENDIX I. NuTATIQl* USED IN THIS MANUAL 



$ 

'ESC 

•CR' 

'LF' 

'DEL' 

'SPACE' 

(CTRL)-A 
CTRL-A 
-^A 

(EDIT)-A 

(...) 
II 11 



ESC key, also called ALT MODE or ENTER. 

S3C key. 

(Carriage) Return key. 

Line feed key. 

DELETE or RUBOUT key. 

Space bar. 

Control characters are typed with the aid of the CONTRUL 
key. Shown here are three "standard" nays of indicat- 
ing CTRL-A. 

Edit characters are typed with the aid of the EDIT key. 

Brackets indicate typing that is done while holding 
down the EDIT key. (EDIT)-A and CA3 wean the saae 
thing. 

Brokets are sometimes used to enclose a description of 
required arguments. 

Parentheses are sometimes used to enclose optional 
arguments or information. 

Double quotes are used inside text to delimit a command 
or a string. 



APPENDIX li. TEC/DATAMFDIA TV-EDIT COMMANDS 



notation: 



CR 
LF 
SPACE 
DEL 



n 



c 

s 

nunbers 



ESC, ALT MODE. Instead ot typ 
coffljuand, you can hold down t 
as you type the command. Th 

Control character Indicator 

(Carriage) Return key 

Line Feed key 

Space bar 

DELETii or RUBUUT key 

minus sign before command lett 
is to do the command backuar 

count before corawand letter is 
"repeat" the command n tin 

"»ord mode" option available ( 
letter to delete 

"line mode" option 
letter to delete 

command requiires' a 

connand requires a 



Ing the ESC and then the 

he EDIT key (orange on TECs) 

ey mean the same thing- 



( Insert, et 
available ( 
(insert, et 
target chat 
(target) st 



er is optional (its effect 
ds) 

optional (its effect is to 
es) 

type 'DEL' after command 
c.) words) 

type 'CR' after command 
c.) lines) 
acter 
ring argusent 



page numbers in this manual 



Pseudo-commands (not seen by the command interpreter); 



'L 

'0 



Again. Repeat last command. 

call), 20 
Leap. Abort a command, 19 
Suppress output, 19 



(Predefined string 



SHIFT/ Invert keyboard input case. Generated by lower-left- 
SHIFT LOCK corner key of the 5x3 pad (TECs only), 22 



Genuine commands (seen by the command interpreter): 



Sn 


LF 


$-n 


CR 


$-n 


SPACE 


S-n 


DEL 


$ 


II 


$ 


m 


$n 


( 


$n 


) 


$ 


/ 


$n 


< 


$ 


= 


S$ 


= 


~L 





Cursor down, 14 

Cursor down, by lines, 15 

Cursor right, by characters, 14 

Cursor left, by characters, or up, by lines, 15 

Detine a string to be the text on a file, 28 

Enter a character in octal, s must be octal string, 23 

Cursor left, by words, 15 
Cursor right, by words, 15 
Begin/end ot string definition, 27 

Cursor left by columns, 14 

iNhere are we, what's the character? 20 

indicate uppercase/lowercase/control characters of 



$n > Cursor right/ by columns, 14 

$n \ Cursor down, 14 

Sn * Cursor up, 14 

$ @ Go to next place according to Place List, 5, 6, 13 

$-n A Again. Repeat last coamand, 20 

$ 8 iireak a line, 26 

$-n C wl Copy aords or lines, 26 

S-n D wl Delete words or lines, 16, 17 

$-n .D wl Hide (store) copies of words or lines, 26 

$$ -D c Duffip strings in TV-ST8I!sGS.PMAP file, 29 

$$ -D. Dump strings in currently assigned set, 29 

S F Save-and-Continue, 12 

$S F finish, 12 

$p.l G lio to Page p Line I, 13 

$n H Shift next n input characters (tor TECs), 22 

$$ 5i Shift lock (for TSCs), 22 

Sn I wl Enter insert mode, insert, 17, 18 

$- J Join tao lines, 26 

S-n K Delete characters, 17 

Sn L Shift to lower case (for TECs), 22 

Sn .L Convert text to lower case, 22 

S-n M wl Hove a word or a line, 26 

S N Hetresh current line, 21 

S ON Hefresh message line, 21 

S-n H Hefresh n lines, 21 

SS N Hefresh entire screen, 21 

S Oops. Undo the delete, 25 

$- P Insert a page mark, 18 

S-n R wl Recover words or lines, 25 

S Re Retrieve a string, enter it in file, 28 

SS .R c Read strings from TV-STRINGS. PMflP file, 29 

SS mR. Head currently assigned set of strings, 29 

SS .RO Clear strings, 29 

S-n S wlc Character search, 23, 24 

Sn T s String search, 24 

Sn U Shift to upper case (for TECs), 22 

Sn .U Convert text to upper case, 22 

S-n ¥ Window, 13 

Sn X Cursor to colunn n of window, 14 

SSn X Set window width to n columns, 11 

Sn ¥ Cursor to line n of window, 14 

SSn Y Set window height to n lines, 13 

S-n 2 wlc "Zap", delete to a target character, 24 



A BRIEF GUIDE TO TVSDIT 

If you make an error while typing a Message you can either delete bacJr to 
the point uhere the error aas made or invoke an editor. To delete characters 
type the key marked "del" or "rubout" on your keyboard. To invoke an 
editor hold down the key marked CTRL and type a B. The computer will 
respond with tne query: 

(Insert file or invoke editor (F,E, or ?)? 
If you type an E at this point the computer Mill then ask for the type 
of editor as follows: 

(editor: 
Typing "TVE" and the hitting the key marked ESC «111 put you into 
TVEDIT. Note tnat tvedit only works on datamedia terminals and will 
not function on lis or other "hard copy" terminals. 

There are a nuaber of simple commands to facilitate editing your 
file. Most of these require that you hold down the key marked EDIT 
on your keyboard. If your terminal does not have the EDIT key you 
can get the saffle result by prefacing each comaand with an ESC. 

Once you are inside TVEDIT there are two types of things you can do. 

Vou can do commands which i«odify the file and you can execute commands 

to reposition the cursor (the blinking underline which shows where you 

are). The following are cursor movement commands: 

EDIT- > Moves the cursor onecharacter to the right 

EDIT- < Moves the cursor one character to the left 

EDIT- " Moves the cursor up one line 

EDIT- if Moves the cursor down one line 

EDIT- ( Koves the cursor one word to the left 

EDIT- > Moves the cursor one word to the right 

All the TVEDIT coroBands will also to a numeric argument of the form 
EDIT- 8- cmnd ,such as EDIT-3-< which will move you three 

characters to the left. To do this you would hold down the key marked 

EDIT/ type a "3" and then type a "<". 

If you type a line without holding down the EDIT key whatever you type will 
overwrite whatever is at the current cursor position. To insert text 
type EDIT- I. This will put you In insert mode. Now whatever you type will 
be inserted at the current cursor point. I^oving the cursor will take you out 
of insert mode. 

To delete a character hold down the EDIT key and type a K.This will cause 
the character at the current cursor position to be deleted. 

Mhen you are through editing you can return to MSG by typing esc esc F. 
Now you will be back in MSG at the end of you file- To see what you have 
already typed hold down he CTRL key and type E. 



APPENDIX II. lEC/DATAMEUiA TV-EDIT CCMJ^AfiDS 



notation: 






CR 
LF 
SPACE 
DEL 



n 



c 

s 

numbers 



ESC/ ALT fiODE. Instead 
command/ you can hold 
as you type the cofflroa 

Control character indie 

(Carriage) Return key 

Line Feed key 

Space bar 

DELETE or RUBQUI key 

minus sign before comma 
is to do the coomand 

count before comtBand le 
••repeat" the cominand 

"word mode" option aval 
letter to delete (ins 

"line roode" option aval 
letter to delete (ins 

command requires a targ 

conraand requires a (tar 

page numbers in this aa 



of typing the ESC and then the 
down the EDIT key (orange on TECs) 

nd. They mean the satae thing. 

ator 



nd letter is 
backwards) 
iter is optional 
n times) 
lable (type 'OEL 
ert/ etc.) words) 
lable (type 'Cfi- after 
ert/ etc.) lines) 
et character 
get) string argument 
nual 



optional (its effect 
(its effect is to 
after command 
command 



Pseudo-commands (not seen ijy the command interpreter): 



'L 
'0 



Again, Repeat last coneand. 

call)/ 20 
Leap. Abort a command/ 19 
Suppress output/ 19 



(Predefined string 



SHIFT/ invert keyboard input case. Generated by lower-left- 
SHIFT LOCK corner key of the 5x3 pad (TECs only), 22 



Genuine cooisands (seen by the coamand interpreter): 



Sn 

$-n 

S-n 


LF 
CR 
SPACE 


$-n 

$ 

$ 


DEL 

II 


$n 
$n 
$ 


( 
) 
/ 


$n 

$ 
s 


< 



Cursor down/ 14 

Cursor down, by lines, 15 

Cursor right/ by characters/ 



14 



Cursor left/ by characters/ or up/ by lines/ 15 

Oeflne a string to be the text on a file/ 28 

iinter a character in octal, s must be octal string/ 23 

Cursor left/ by words, 15 

Cursor right, by words, 15 

Begin/ end of string definition/ 27 

Cursor left by columns, 14 
wfhere are we, what's the character? 20 
Indicate uppercase/lowercase/control characters of 
a line, 21 



$n 


> 




$n 


\ 




$n 


A 




$ 


@ 




$-n 


A 




$ 


B 




$-n 


C 


Ml 


$-n 


D 


wl 


S-n 


.0 


wl 


SS 


.D 


c 


SS 


.D. 




$ 


F 




$$ 


F 




$P.l 


G 




$n 


H 




$$ 


H 




$n 


I 


wl 


$- 


J 




S-n 


K 




Sn 


L 




$n 


.L 




S-n 


¥: 


wl 


S 


U 




S 


ON 




S-n 


U 




SS 


N 




S 







s- 


P 




S-n 


R 


wl 


S 


R 


c 


SS 


.R 


c 


SS 


.R. 




SS 


.RO 




S-n 


S 


wl 


Sn 


T 


s 


Sn 


U 




Sn 


,V 




S-n 


W 




Sn 


X 




SSn 


X 




Sn 


¥ 




SSn 


¥ 





Cursor right/ by coluiens, 14 
Cursor dowfi/ 14 
Cursor up/ 14 

Go to next place according to Place List, 5# S, 13 
Again. Repeat last coaimand/ 20 
Break a line, 26 

Copy words or lines/ 26 

Delete words or lines, 16, 17 

Hide (store) copies of uords or lines, 26 

Dump strings In TV-STRINGS. PMAP file, 29 
Duffip strings in currently assigned set, 29 
3ave-and-Continue, 12 



Finish, 12 




Go to Page 


t 


Shift next 


n 



Line 1, 13 

input characters (tor TECs), 22 

Shift lock (tor TECs), 22 

Enter insert mode, insert, 17, 18 

Join two lines, 26 

Delete characters^ 17 

Shift to lower case (for TECs), 22 

Convert text to lower case, 22 

Move a word or a line, 26 
Refresh current line, 21 
Refresh message line, 21 

Refresh n lines, 21 
Heiresh entire screen, 21 
uops. Undo the delete, 25 

Insert a page mark, 18 

Recover words or lines, 25 

Retrieve a string, enter it in tile, 28 

Head strings from TV-STRINGS. PM*P file, 29 
Read currently assigned set of strings, 29 
Clear strings, 29 

wlc Character search, 23, 24 
String search, 24 
Shift to upper case (for TECs), 22 

Convert text to upper case, 22 

isindotf, 13 

Cursor to column n of window, 14 

Set window width to n columns, 11 
Cursor to line n of window, 14 
Set window height to n lines, 13 

S-n Z wlc "Zap", delete to a target character, 24 



28-Sep-77 



CONTENTS 



<DQC^:E!iiTATiON>TV£DIT. UPDATE 

«ew FEATURES OF DATAMEDIA/TEC/IWLAC TV-EDIT 
******* ************************************ 



1. NEW CUMMANDS: Q, y, ;, and F 

2. OLD BUGS. SNDMSG entry and terminal speed 

1. HEU CO!«f«ANDS 



Insert a single character when not in insert nsode- 

$Q Insert the next character typed rather than overwriting, 
regardless of the setting of insert aode. 

Transpose characters. 

$V Transpose the last character typed with the one before It. 

Comment features. 

$; If a comtaent already exists on the current line, align it to 

the conraent coluiBn. Otheriiise start a new connent at the coisnent 
line. 

$-/ Heraove any comment from the current line. 

$n; Set the comajent column to be coluwn n. 

$.; Set the coBRent coluren to be the current x position. 

A cofflinent is delimited by a coBment start string and a 
comment end string (possibly null), depending on the 
extension of the file being editted. The defaults are 
'•;" and null 

CCL startup. 

$$-nF Just like $$nF, except that the EXEC will reexecute the last 
CCL type command (ie LOAD, COMPILE, EXECUTE, etc). 
This facilitates movement between the editor and an assembler. 

2. OLD BUGS 



SNDMSG entry. 



If TVEDIT is entered from SNDMSG, $SF will overwrite the old 
version, rather than creating a new one which 3NDHSG would not 
find. 



Terminal speed. 



TVEDIT now determines the terminal's speed when started up and 
will pad accordingly. 



lO-Oct-75 



CONTENTS 

1. CHANGES TO COMMAMDS: F, G/ g, fixing a place to go to, .L, 

•Uy and X 

2. OR IN INSERT MODE; TABS: Minor modifications 

3. strings: <log-in>TV-STRINGS.PMAP; '(Strings)' in starting TV 

4. TV DlRtClOHY: Conserving file space 



1. CHANGES TO COMI»ANDS 



Save-and-contiaue. 

$F Replaces $$.F 

Go to Page. Line. 

$+m.nG (io to current page + », line n. $-»-G Is now 

equivalent to $G 
$-ffl.nG Go to current page - m, line n. $-G goes to top 

of previous page- 
Si Go to next place in the place list. Replaces S+G 
$-§ Go to the last fixed place- 
Fixing a place to go to itiE¥ FEATURE). 

$.@ Fix current place for further reference. 

Current place can also be fixed by typing two ESCs (or EDIT-ESC) 
before G and (4 commands: 

$$nG Fix current place, go to n. NOTE: $SG no longer 
takes to end of file. Ose $y99G instead. 

$$8 Fix current place and go to next place in place list. 

$$-§ Fix current place and go to last fixed place. This 
alloys bouncing back and forth between tyo places in 
a file. 

RESTRICTIONS; There is only one fixed place at a time. It 
is stored as a page- line number and is NOT updated when page 
marks and lines are inserted and deleted. You cannot (yet) 
fix a place in one tile and get there bhile editing another 
file- The fixed place is not saved frost one editing session 
to the next. 

Converting words and lines to upper or lower case- 

$n.U<DEL> Convert n words to upper case. 
$n.L<DEL> Convert n words to lower case. 

$n.U<CR> Convert n lines to upper case- 
in. L<CR> Convert n lines to lower case. 

Nothing comes free. To convert individlal letters, an extra 
character amst be typed, e.g-. 



$n.UU Convert n characters to upper case (this used to 

be "$n.n"). 
$n,LL Convert n characters to louer case. 



Pointing. 



$nX Point to column n of the current line. 

UEu FEATURE: If target coluasn Is beyond the righ or 
left margin/ the line shifts to bring target to view. 



CR Ih INSERT MODE; TABS 



Typing a RETUKN yhile inserting within a line Is now a no-op (it 
beeps). "$I<CR>" still inserts a line above the current line- 

The TAB "accordian" is now less of an accordian than before. 
Inserting and deleting of text is propagated to the first TAB but not 
beyond. Inserting and deleting of TABs is not propagated. It is nou 
easier to delete TABs. Setable TABs similar to those on a typewriter 

are yet to come. 

3. STRINGS 



TV-STRINGiJ.pMAP file is now taken from the log-in directory. It 
used to come frorr the connected directory^ and has resulted in users' 
picking up strange strings and damaging their text files with then. 

The '(Strings)' request at the beginning of edit is gone^ and 
you can no longer perasanently assign a set of strings to a file. 
This feature was used in only five of over 250C TV files at IMSSS 
and SUMEX. String sets addressed by the letters A...Z still exist. 
S$-R. and $$.D. now refer to the last "letter" set accessed during 
an editing session^ or to the default set if none has been accessed. 

4. TV DIRECTQRV 



TV directory, which aids in locating text pages of a file, used 
to occupy file page (TENEX page) 777 (octal). This ment one-page 
overhead for each TV file. For files less than 20 pages, the dir- 
ectory is now stored on the page where the text ends, beyond the EOF 
pointer, provided that it fits there (in 98% of the files it does). 
If it does not fit and the file is at least 3 pages the directory is 
stored on page 777. For files with 20 pages or more (about 5% of TV 
files have over 20 pages) page 777 is always used as a protection 
against losing the directory when the file is appended to. 

P.S. Due to the fact that a number of prograas (SOS among them) read 
past the end-of-tile pointer, this feature has been disabled. It was 
nice while it lasted. 
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1. 
2. 

3. 


MEW COMMANDS. 
CHANGES 10 OLD 
OD<DEL>, and 
HEM FEAl'URSS. 



-T, .«, .), .(, 5$,k, and $$.H 

CQMMA,NDS. 0, J, 8, *, LP, \/ CR, -I, -B, -Z, $SK, 
$A after $$.U or $$.L 
File last edited; Window diaensions. 
4. OLD BUGS. Striny search; Large tiles. 



1. NEW COMMANDS 

Searching backwards. 

S-nT<string> Backward string search of n lines. Searching 

proceeds up by lines, and left to right within a 
line. Backward search takes about 1.5 times as 
long as forward search. 

Additional windohing control. 

$n«'A* Scroll the screen so as to raake the current line 

the nth from the top. $.« puts current line 
to the top and $$.ii puts it to the bottom. 

S-n.Kii Make current line the nth from the bottom. 

Moving cursor past words to beginnings of blank fields. A way to get 
to ends of hords. 

$n-) Point to the nth blank field on the right. 

$n.( Point to the nth blank field on the left. 

Next two commands offer relief when a line or word delete buffer Is 
full and the user no longer wishes to keep the stored lines/words. 
These cojninands only unprotect the saved items. They dissapear beyond 
recovery when turther iteas are oeleted. 

$$.R<CK> Release line delete buffer. 
SS.R<D£L> Release word delete buffer. 

Changing file a.ode (uppercase/lowercase) in the jaiddle of an edit. 

$S»H Shift file mode from the current case (upper or 

lower) to the opposite. The new case becomes the 
default for the file (it is reneBbered in the user 
setable word of the file descriptor block). 



2. CHANGES TO OLD COI^MANOS 

Mistaken "oops". 

$0 When you are entering text and accidentally type 

$0 wtien intending to type SI your lose your line. 
You can now do a second oops to get the lost line 
ijack (sometimes it cones back on the third). 

Joining and breaking of lines. 

$nJ Join current line to the next and insert n spaces 

in between. 

$$J Join current line to the next leaving leading 

blanks of the next line alone. Trailing blanks 
right of the cursor are lost. If cursor poins 
beyond the last visible character ol a line# 
beginning of the next line is brought there. 

$nE Break current line and insert n spaces in front 

of the neu line, SB means $0B instead of SIB. 

SSB Break the line leaving blanks as they were. This 

is equivalent to the old SB. 

Also try $-nJ/ $-nB/ $$-J, and $$-B. 

'Up cursor' irons top of screen^ and 'down cursor' troa bottom of screen 
or at end ot file, have been too stingy in the past causing unwanted 
overtyping. 

$** Up. Screen will scroll if current line is top line- 

Sn* (and $$") does not cause scrolling. 

<LF>, S\ Down. Screen will scroll it current line is bottoa 

line. Makes a new line at end of file. $n<LF> 
and Sn\ do not. 

S<CR> Meu line. Makes a new line at end ol file- $n<CR> 

does not. 

Inserting and deleting. 

$-nI<CR> Insert n blank lines above the current line and 

leave cursor on the (old) current line. 

$-nD<CR> Delete lines/ zap lines. These cooHiands delete 
$-nZ<C8><char> lines from above the current line and leave the 

current line intact. 

SSK Puts the deleted end of the line in the line delete 

buffer from where it can be retrieved with SR<C8>. 



word mode handling has been rewritten. The coEmands most affected are: 

$nD<DEL> Delete n words. If cursor points at a blanky the 

blank area from the current position to the begin- 
ning of next word counts as one word. 

$OD<DEL> Delete to end of curren blank fields but do nothing 

if cursor points at a visible character. This Is 
useful in left-Justifying te^ct. 

S-nD<DEL> Delete words/ zap words. These coramands delete 
S-nZ<DEL><chr> words on the left and leave the current word intact, 

Converting consecutive lines to upper or lower case. 

$$.U/ SS.L Again coiaaiand SA after S$-U or $$.L converts 

the NEXT line. 

3. NEW FEATURES 



FILE LAST EDITED. The name of the file last edited is stored in 
TV-STRINGS. P«AP and offered as the default at the beginning of a new 
editing session. 

WINDOW DIHENSIQKS. The height and width ot the window last in use 
is saved in T¥-STRINGS.PMAP and restored at the beginning of a new 
editing session. 

4. OLD BUGS 



STRING SEARCH. Occasionally T-search would find a word but would 
display a wrong window. Two cases in which this used to occur have 
been identified and correcred. 

LARGE FILES. TV uses file space between end of file and page 770 
(octal) as temporary output space. Filling up of this space has caused 
the editing to abort rather than allowing orderly finish. Straighten- 
ing out of the resulting file has been a tldlous chore. New version of 
TV warns the user of insufficient work space and lets hia finish the 
edit. 



5-May-75 



1. MaximUiii line length is 300, formeriy 150. 

2. f^ormal asargins are aarked with colons (:), long lines with 
asterisKS (*), and indicator lines Mith the equals sign (=), 
formerly dots (.)/ dashes (~), and asterisks (*), respectively, 

3. Long tile natiies will not cause the "DIRECXOHV FULL" message. 



22-Mar-75 

1. RANDOM ACCESS. 

2. MEAT HilPPENS TO YGUR FILE WHILE EDITING. 

3. RECOVERING AFTER CRASH OR *C EXIT. 

4. WAYS TO LOSE k FILE. 

5. COJ«MAwDS FOR HAKI«G A NEM VEKSIQJ^ AT FINISH. 

6. SOS FILES. 

7. CHANGES TO OLD COMMANDS: $$/, $$", $$.F, $G, $1, $-Wy and $=. 

1. RA!<DOM ACCESS. 

The main news is RAMOOM ACCESS. The sole purpose of randoa access is 
to put any part of a text file within fast reach. The speed-up is aost 
noticable with the $nG and $$.F coamands, but also $$F and string 
search are somewhat taster. Furthermore, your roost recent editing 
(since the last $$.f ) has no« a better chance ojt surviving a system 
crash. 

Frequent use of $$.F is recoromended. 

The cost of random access is file (disk) space. One file page 
(page '777) is nsalntainea as a directory. It tells Hhere in the file 
the text page marks are located. Disk pages of a random access text 
file are not usually fully packed since both inserting and deleting of 
text can bring about wasted space. Vou should expect the resulting 
files to be 20i& bigger than the old TV-Edit files (which were fully 
packed and had no page directory) and 10% bigger than SOS files (uhlch 
have line numbers and other wasted space). 

2. WHAT HAPPENS TO YOUR FILE WHILE EDITING. 

While editing/ the file is kept in a special TV-Edit foraat, and only 
the new TV-Ecit can properly access it. ihen editing is finished (with 
$$F)/ the torraat is changea back to norwal/ siaklng the file available 
to other programs. An attempt by other prograBS to read an unfinished 
file results in a warning Message. 

*** WARNING *** 

If editing is aborted with *C or a system crash, you must next time 
edit the file with the NEW TV-Edit. Editing it with the old TV will 
destroy information necessary tor recovering trow the crash, resulting 
in the loss of the entire file! 

In the edit-tiffle file format the first 512-word disk page (file 
page 0) contains the warning message, subsequent disk pages contain the 
original file as it appeared at the start of the editing session (disk 
page is moved to the end of the original file to aiake roowi for the 



warning Message), updated disk pages are stored just beiou disk page 
770 (octal), and disk pages 775-777 contain the access inforaation to 
the file. «hen tinished, disk page 777 remains and it tells where the 
page marks ot the text file are located. It is this page directory 
that makes possii)le random accessing fcy TV. The directory is not 
necessary for reading the tile by other prograos. 

3. RECCVERING AFTER CRASH OR *C EXIT. 

When starting to edit after a crash (or a *C exit), the editor takes 
you to the approximate place ot the crash and inserts two page narks. 
The text above the page marks is the most recent, and any duplication 
of it below is older and hence a candidate for deletion. (Unless the 
page marks appear at the beginning of the file, the first line below 
the page marks is the tail end of a line above the page narks.) — The 
duplication of text results from an attempt to hang onto as much of 
your most recent editing as possible. 

SCRAMBLED fclNDOW. Sometimes a crash leaves behind a scrambled 
window. It is always below the spot where the editor starts after a 
crash, and it fills exactly one window (23 lines). This scraebled 
window is marked off by double page narks both above and below, and 
the lines within are usually out of order. After cleanup, look for a 
copy of the bottom line Just below the page marks. — A scrambled window 
is produced «hen the ".WAI1.0.." message appears, but is cleaned up 
subsequently unless preserved by a system crash. It is a monument to 
substandard programming. 

4. ijAVS TO LOSE A FILE. 

If a crashed file is edited with another editor, the old TV, for in- 
stance, and that editing is finished, or if a crashed file is appended 
by some program, partial or total loss of the file occurs. The warn- 
ing message in tne beginning of the file is designed to minimize the 
hazard. The proper procedure is to abort, with CTRL-C, any program 
that allows you to read the warning message, and edit and finish with 
the new TV-Edit. 



5. COMMANDS FOR MAKING A NEW VERSION AT FINISH. 

The edited tile can either replace the old version of the file or 
become a new version at the time of finish. The default is "create 
new version" for crashed files and files in other than connected di- 
rectory, "replace old version" otherwise. You can beat the default 
by giving a count in conjunction with an "F" command: 

$$1F Finish, replace old version (results in 1 version). 
$S2F Finish, make a new version (results In 2 versions). 
$$1.F Save-and-continue, clear the new version request. 

— An appropriate time to use this command is after 

a crashed file has been cleaned up and a backup is 

no longer deemed necessary. 
$$2.f Save-and-continue, set the new version reguest. 

— Hse this command as soon as you decide that you 



want to retain a backup version. You will then 
be iree to forget it when actually finlshing- 
$$¥ Finish, new version generation according to the most 

recent request. 

$S.F (no count given) leaves the new version reouest unchanged. 

If a new version is generated^ the old version is returned to 
its original form, i.e., as it was at the beginning of the editing 
session. 



6. SOS FILES. 

¥ou can choose to retain or delete SOS line numbers when you start to 
edit. Request to retain or delete comes after the "(Strings)" request 
in the initial dialogue. The default is to Delete. Regardless of your 
choice, the file is copied and the original file retained as an old 
version. — In Read-only ojode the SOS line numbers are always displayed. 

7. CHANGES TO OLD COMMANDS: $$/, $$", $$.F, $G, $T, $-«, and $=. 

DEFINING AND RETRIEVING STRINGS (MODIFIED). Users of strings are 
familiar with the message ".ALREADY. DEFINED. ..'¥'. TO. REDIFINE.. etc.". 
In the new TV you can avoic this message by typing two ESCs before the 
/ or " when redefining a string: 

$$/ Begin string definition; no hassles^ please. 
$$" Define a string according to the text on the 
window; no hassles^ please. 

The aouble quote (") coamand no longer takes its string ID froa 
the file. The user has to type it in. When retrieving strings with 
the "SR <string ID>" command/ only the string body is written in the 
file (the old forwat was: String ID, string body# $/). — The new foraat 
is designed to be used for transporting text froa one part of the file 
to another, or to a different file. The old format was better suited 
for storing string definitions in a text file. That function has 
since been taken over by the $$.Dx and $$.fix commands/ and the 
TV-STRINGS. PHAP file. 

OTHER REFINEMENTS. 

— $$.F, SG and $T coamands are more econonical in updating the 
display. 

— S-iy puts cursor to the top of window if current line moves out 
of view. 

— Output forinat of the $= cowmand has been changed. 

— Several eld bugs were discovered and replaced with a host of new 
ones yet to be dlscoversed. 
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Current changes to T¥-Edit deal with: 

(i) starting the edit, .PL files; 

(il) new Datamedia keyboard with EDIT key; 

(iii) save-and-continue; and 

(iv) saving and loading of command strings, IV-STRINGS.PKAP files. 

13 ew commands are: 
$+G, $$.F, $S.Dx, S$.i3., $$.Rx, $$.R., and $$.H0, 
where x stands for a letter. 

STARTING 



The starting cialog has four questions, mhenever a default 
option exists, it is displayed to the left of a double slash *'//"• 
Use 'CR' or 'ESC to accept the default- 'ESC «ill skip over the 
remaining questions (it is the expert's way to "get with it"). 
Use the ? to find out about the possible answers to each question. 

The starting questions are: 

(FILE NAME). For default options, Cconfirm] the name with an 'ESC. 

(PAGE.LISE). Place to go to. Default is the place of last finish. 
A list ot places to edit can also be read froa page 1 of a speci- 
ally named file. The place list file for the file "name.ext" is 
called "#name-ext.PL". The editor comnand $*G takes through 
consecutive places in the list. — The SEARCH program is able to 
generate appropriate place list files. (See SEARCH. MANUAL for 

details.) 

(MODE). Default is Write mode for files in your own (connected) di- 
rectory, head-only for files in other directories. In write node, 
the "L" or "U" of last tlae is the default. 

(STRINGS), you can make or break an association between the text 
file and a set of coBwand strings. No loading of strings takes 
place here. Loading and saving is done by editor comoands. For 
details, see Section "STRINGS" below. 

IMPLEMENTATION. File mode (U or L), the place of last finish, 
and the assignment of a set of strings is "reneinbered" in the user 
setable word of the file Descriptor Block (FOB). This word is up- 
dated only when editing in write «od€. Note also thet in COPYing 
the file or rewritinQ it by some other progran (e.g., in switching 
between different editors), this information is not copied. 



EDIT KEY 

The EDIT key is used to type coremands. Instead of typing an 
'ESC and then a comiEand letter/ type the coaraand letter while de- 
pressing the EUIT key. Commands that used to require the typing of 
t«o ESCs can now be typed with one ESC and the EDIT key. 



SAVE-AND-CUNTINUE 



$$«F will finish writing the output file# restart the edit, and 

return to the place sphere the $$•? comsBand uas typed while 
".yOU.s4lLL.HAVE.TO.'«?AIT.". This gives soroe protection against 
systen crash. 



STRINGS 



Comaiands now exist for saving and loading of all strings at 
once. Sets of strings are identified by the letters A,.../Z. The 
cofflmands tor saving and loading a set are (x stands for a letter): 

SAVING (*) 
$$.Dx Strings currently in raeaory are filed (Dumped) under x. 
SS.D. Strings in memory are filed in the currently assigned set. 

LOADING {**) 
$$.Rx Load (Read) strings from set x. 
$$.R. Load currently assigned strings. 
$$.R0 Clear strings in memory. 

notes: 
(*) In saving, the set in the file is REPLACED by the set currently 
in memory. 

(**) In loading, the set in file is MERGED to the set currently in 

memory. Thus a string in memory is redefined only if it is de- 
fined in the set being loaded from file. 

AUTOMATIC SAVING AND LOADING. In addition to the sets of 
strings Identified by the letters, there Is a set called the "last 
set". Strings in meaiory are saved as the last set whenever editing 
is FINISHED. The last set is automatically loaded when the editor 
is STARTED. The $$.Dx and $$.Rx commands refer to the last set 
if X is not a letter or a special character (non-0 digit is ok.). 

IMPLEMENTATION. A special file 'TV-STRINGS. PMAP ' is created in 
your directory. The letters refer to TENEX pages of this file. The 
letter A, for instance, refers to page 101 octal, the "last set" 
to page 0. The strings are stored in the TV-STRINGS. PMAP file in a 
special TV-Edit format (which is not standard text format). The file 
cannot be reed using the TYPE command. 

DELETING PAGES of the 'TV-STRINGS. PMAP'-FILE. If $$-Dx command 
is given when there are no strings in Kemory (you have just executed 
the SS. RO command), page x of the string file is removed from the 
file. This is a way to delete unnecessary pages from the string file. 



There is no point 
time when you use 



in trying 

TV-Edit. 



to delete the file- It cones back every 



